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1. Introduction 


IBM Integration Bus version 9 has introduced a conversion utility to assist with the conversion of 
WebSphere Enterprise Service Bus applications to Integration Bus applications. 


The objective of this lab is intended to show the basic framework for these conversion capabilities for 
WESSB applications by using the Stock Quote sample application, packaged in WebSphere 
Integration Developer as a WESB Sample. 


This lab has three primary tasks: 


1. Import the Stock Quote sample application into the Integration Bus Toolkit. 

2. Run the conversion editor. 

3. Perform a number of remaining conversion tasks to make Stock Quote a working service in 
Integration Bus version 9. 


1.1. StockQuote Application overview 


The Stock Quote sample addresses the business need of a financial services company that provides an 
interactive web-based stock market service to its customers. 


The company wants to differentiate itself from its competition by offering tiered levels of service. Using the 
following requirements: 


e Offer the delayed and real-time stock quote services as a single service, which dynamically 
determines which external service to invoke based on the customer's subscription level. 

e If the real-time service is unavailable, route requests to the delayed service without affecting the 
running application. 

e Log all requests to the service to satisfy audit requirements 


The mediation service that runs on the WebSphere ESB or IBM Process Server is contained in a single 
mediation module called StockQuote. 


The StockQuote mediation module consists of the following elements: 


¢ StockQuoteService has a WSDL interface, called StockQuoteService, and uses SOAP/HTTP. 

e StockQuote_MediationFlow contains the mediation flow. 

e RealtimeService and DelayedService has a web service binding and an interface that matches 
the real-time (premium) and delayed (regular) service. 
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The diagram below shows the request flow that defines the mediation logic applied to the message as it 
flows through the StockQuote_MediationFlow component to the target service providers. 





IfcustomeriD not found 
in Lookup set a default 


subsciptionLevel 


Transform message to 
DelayedService format 






= 
ea) 
Add persistent property Use customenD to lookup = ® = > = be ©) DelayedServicePortTypePartner 
subscriptionLe vel subscriptionLevel SetCustomerType ia] 4g getQuote 
TransformToDelayed 
(1) StockQuoteService i] o fa ® « ° a 
7 cacuaa ns) fal = © = © © E) RostinaservicoPertTypePertner 
% getQuote 


Log Lookup 
Fier TransformToReallime 
— g message , : ‘ 
-Prom ote pattern property & >} 1) StockQuoteService 


-Route message based on 
subscriptionLe vel 














The diagram below shows the response flow that defines the mediation logic applied to the returning 
message as it flows through the StockQuote_MediationFlow component from the target service provider 
to the client. A Message Element Setter is used to copy the value of subscriptionLevel from the 
correlation context to the property qualityOfService in the message. 


The qualityOfService text indicates "Premium" to a response that is returned from the real-time service, 
and "Standard" to a response that is returned from the delayed service. 


The qualityOfService text is displayed in the client to indicate the service provider that was used. 





Transform message to 
StockQuoteService format Message returned to 
StockQuoteService 


Message returned 
from service provider 





© «4 @) StockQuoteService 


Delayed To SiockQuote...  g e¢Quote 





(E) DelayedServicePortTypePartner ._ > 














Tia 
Ay getQuote bs P 
— 
Delayed Stock Quote Fail 
RealtimeServicePortTypePartner > 
a ?o 
.) getQuote 
¥ Transform message to subscriptionLevet 
StockQuoteService format property copied to 
qualityOfService 
Message retumed 
from service provider 
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1.2 Lab preparation 


This lab will use a dummy application running on WebSphere Application Server. Make sure that ODM 
WAS is running. 


Open a Firefox browser and click the bookmark for “StockMarket WS’: 





If it is running, you will see this response: 





File Edit View History Bookmarks Tools Help 


€ 16M Integration * | (_} http://betaworks-es.. services/StockQuote * | + 
betaworks-esb01;9080/StockMa 


arketWS/services/StockQuote 

















Integration Bus Cons... | {_} WAS Admin Console (63) Workight Console 3) Decision Center Enter... 3) Rule Execution Serve 


{http://sq.betaworks.ibm.com}StockQuote 





Hi there, this is a Web service! 











If it is not running, start using the icon on the desktop: 
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Import the Stock Application into the Integration Toolkit 


1. In the Integration Toolkit, import the WESB Resource Library. This library contains a 


database definition file and message test files that are necessary for the StockQuote 
application. 


Right-click on a blank part of the Application Development view, and select Import...> Other 
> Project Interchange. 


Import the PI file C:\student\WESB_Conversion\resources\WESB_Resources.zip 


1B import Project Interchange Contents 





=|5) xj 
Import Projects =" 
Import Projects from a zip file. 
Ss 
From zip file: [C:\Users\ibadmin\Desktop\WESB_ResourcesDBversi +] {i 
Project location root: | C: \workspaces\IBWorkshopNEW Browse. 
Y] = SQSAMPLE 





1S WESB_Resources 





(?) 








This will import a library “WESB_Resources”, and a referenced project SQSAMPLE. 
Click Finish. 
Now import the Stock Quote sample application. 


Open the Import wizard again. This time, select the “WebSphere ESB project Interchange 


item. (You can locate this quickly by typing ESB into the “Select an import source” box. Or go 
to File > Import > Other > WebSphere ESB project Interchange: 


1B Import 
Select 


lolx! 


Import WebSphere ESB projects and their dependent 


es 
Projects from a Zip file. 


Select an import source: 
ESB 








=) Other 
$B WebSphere ESB Project Interchange 








Click Next. 
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3. Use the Browse button to set the import file to 
“C:\student\WESB_conversion\applications\PI_StockQuote_lID8.zip” 


10 Import WebSphere ESB Project Interchange file ; —-/5) x) 


Import Projects 
Import Projects from a zip file. 
aa 


From zip file: [ C:\student\WESB_conyersion \applicatic 7] Browse... | 
Project location root: [(C:\workspaces\WESBCONV Browse... | 


(2 Resources 
SStockQuote 














Select ReWerenced 





stan| coe 





Select both the “Resources” and “StockQuote” items. Make sure “Launch WebSphere 
ESB conversion after import” box is selected. Click Finish. 


4. A“New WebSphere ESB Conversion Session’ will open. 
Set “Conversion session filename” to WESBConvSession1. 
19 New WebSphere ESB Conversion Session 7 | = {oj xj 


New WebSphere ESB Conversion Session 
To create a new WebSphere ESB conversion session file, select a project and 
aa 


specify a conversion session filename. 











The conversion session file contains information about the WebSphere ESB projects that you 
want to convert, your WebSphere ESB conversion configuration choices, and your conversion 





® ea 





Click Finish. 
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5. Go to the “Application Development” view, expand the “Resources” and “StockQuote” 


folders under “WebSphere ESB Projects’. 


These are the components of the original StockQuote application, which will be converted by 


the Conversion tools. 











{= WESB_Conversions 
5-58] WebSphere ESB Projects 
ic) ws Resources 
i & .apt_generated 
i @ gen 
BG META-INF 
| CustomerType.csv 
f 22 DelayedService.wsdl 
-- @ RealtimeService.wsdl 
i B sca.library 
o [X) sca.library. attributes 
: (2) SharedLib_root_objDef.cmt 
~~ @® StockQuote_StockQuoteService.wsdl 
~~ 2 StockQuoteProvider_DelayedServicePortTypeExportt. 
i 2 StockQuoteProvider_RealtimeServicePortTypeExport1 
: (s) StockQuoteRequest.xsd 
i [s) StockQuoteResponse.xsd 
~~ @® StockQuoteService.wsdl 
[S) SubscriptionInformation.xsd 
&-& StockQuote 
@& gen 
(& META-INF 
& xslt 
i (2) DelayedService. _import.mon 
~~ [X) DelayedService.import 
i 2) RealtimeService _import.mon 
~~ [X) RealtimeService.import 
: {X) sca.module 
{X) sca.module.attributes 











6. Inthe Resources folder, open the StockQuoteService.wsdl file. 





ee Indeperdent Resources 
| eWs WESB_Conversions 
1-[e88) WebSphere PSR Projects 


; ~ EE custemerType.cev.dataponl 
: ~  JelayedService.wedl 
(th META-INF 


> 29 RealtmeService wsdl 


bo DX) sca.library attributes 
-~[E) Sharedlib_poot_obiDef.cmt 

~ 29 3tockQuote_DelayedServicePortTypeimport L. wsdl 
~ 3 stockjuote_Realtmeservicevorsl ypelmport 1. wedl 


aqpeServiceHttp_Service, wsdl 
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Te 


You can see the original WSDL design for the StockQuoteService in the editor. Do not 
modify this. Close the StockQuoteService.wsdl tab. 








(1 *WES8ConvSession L.conversion [a StockQuoteService.wsdl 2 NY 




















[F appiicati 28 Si pattems | 5 
€o8°7 
Application Development New.. 








= Independent Resources 
I WESB_Conversions 
=)-lE8] WebSphere ES8 Projects 
EI ah Resources 
»~ | CustomerType.csv 
EE} CustomerType.csv.datapool 
(29 DelayedService.wsdl 
(& META-INF 
~~ 29 RealtimeService.wsdl 
3 2 sca.library 
: [x] sca.library.attributes 
EE SharedLib_root_objDef.cmt 
~~ Z@ StockQuote_DelayedServicePo 



































coe 




































































[Ff getQuoteParameters {é] getQuote 


[IF getQuoteResult [2] getQuoteResponse 






























































In the Resources folder, open the “StockQuote_DelayedServicePortTypelmport1.wsdl” 


file. 


You can see the interface binding defined on the WESB project. 





EB. application Developnent £4 ba Pasterns Cxplorer | == 





| E) sca.tbrary 


[2X] sca.ibrary actribut [8 Sharedib_rcotobjDe | AP OebyedService.nsdl 





Bes 


ew... 





Application Development 
16) indesendertresources 
1S WESB_Conversione 

£53 WebSchere ESB Protects 


We Resuurees 











| pL] CustomerType.cov 
i -~ EB CustorerType.csv.detepoo 
2 Debyedservice.nsdl 
| 4G NFTAINF 
H 4 healtmeservce.wsdl 
=) sca.lrary 


b= |S] Stock@ inteRemense ved 
(22 stockqucteservice_Stockuo“eserviceHttp_servic=.ay 
2B StodkQucteServiec.wad 
| + [S) Subscrbtoninfermationxsd 
BG cen 
1G stockQuete 






















2% DelayedSe: veePur Typelmpur L1_DeleyedSer vicePur [TypetlpSer vice | 








(B DelayedServicePorttype:mport_Delay=cservicePortiypenttrrort 


















































[Delsyedservicerort! ypeinport]_Deayedservicerortl ypert Service 
Prefix: this 

















Terge: ramespace: |http:{/SteckQuetcProvider/Deayedservice/ 
























Close the wsdl without modifying. 
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9. Return to the editor for WESB conversion (WESBConvSession1.conversion). Both imported 
resources are going to be used for this conversion session, so make sure “Resources” and 
“StockQuote” are selected. 


TIB_Resources 
IB StockQuote 





10. Click the “Next >” link to continue: 


heres lh 2 gg tat ge atl olhs 
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11. Click “Export StockQuoteService”. You will see the “Conversion notes” for this element; the 
notes describe the conversion that is assigned for this item. 


For example, in the StockQuoteService item, the component is the initial service described in 
the original StockQuote application. It will be converted to an input node (SOAP/HTTP) with 
a SOAP Reply node that will be generated for request-respond scenarios. 


Selecting other items will display information about the proposed conversion for that item. 





WebSphere ESB Resources: 


[type filter text 





Tne export will be conve'ted to an input node. end optionaly a reply node for request-response operations. 








? 
When corverting an export that has a 2ne-way operation, the WebSphere ESB conversion tcol converts the 
| Se export and its cor2spondirg binding type into an nput noce. For more information about input rodes. see 4 
: + 'StockOuote MediationFlow Irput nodes. 
-[& Import TelayedService’ 
: _--[B Import 'RealtimeSe-viee' 
Ss XML Mape (a! maps are eeected “or conver 














VW/hen corverting an export that has a equest-tesponse operaticn, the WebSphere ESB conversion tool 
converts tie export and its coTesponding binding type into an inpui node and a reply node. For more 
information about message flow nodes, s2e Nodes fcr connectivty. 





ROO eeT eT iia SOT hee Wem eT TO 


ee ee , an oe ee ee Oe en nee er on oe enn nn a oe 


12. Now select Resources -> XSD/WSDL. The WSDL and XSD schema files represent the 
logical model of the message and define request calls/endpoints services for IIB: 








Ihe XSL schema and V/SUL files will be copied into th2 Integration Hus targe: project. 


The WebSphere ESB conversion tcol converts your WebSph2re ESB WSDL fle and ceates a 
if] Export 'Stod:QuoteService’ sch2ma (xsd) ile for ech inline scheme embedded in your YVSDL file. The format of the covverted3 


irl tStockCuote Medati . WSDL file is differznt to the original, but it is logically equivalent. To learn more about WSDL files 
1 Sees fonFow' |) IBM Incegraton Bus, sez Workira with WSDL files. 


_ [> Inport RealiimeService’ 
+ XM Mans (al mans are selected far canversi 
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13. Under the StockQuote item, select “XML Maps (all maps are selected for conversion)”. 


All mappings will be selected and used for conversion. The converted mapping will be part of 
the resulting integration service, using the Integration Bus Mapping Node. 


All transformations are converted, so you cannot deselect any of the map conversions. 





jandconversion 


1. Select WebSphere ESE projects + «# 2. Configure WebSphere ESB resource options » 3. Configure global conversion options > 





Configure WebSphere ESB resource options. Filter resources by name or by using a wildcard character. 


WebSphere ESB Resources: 


ty text 

GS Resources [mmap sage 
He (5) XSD/WSDL DelayedToStockQuoteService_res_lmap-xslit/Delay... StockQuote_MediatonFlow.component 
Gl 2 StockQuote Lookup_req_i.map - xsit/Lookup_req_i.map StockQuote_MediationFiow.component 
a os] Module RealtiimeToStockQuoteService_res_i.map - xsit/Realti.... StockQuote_MediationFlow .component 
lil] Export 'StockQuoteService TransformToDelayed_req_i.map - xslt/TransformToD.., StockQuote_MediationFlow component 


i {Gis Component ‘StockQuote_MediationFiow" TransformToRealTime_req_i.map -xslt/TransformTo... SteckQuote_MediationFlow.component 
[> Import 'DelayedService’ 


All selected WebSphere ESB XML maps will be converted to IBM Integration Bus XML 
maps- 

















14. Similarly, review the “Conversion Notes” for: 


StockQuote: 
- Module 
-Component ‘StockQuote_MediationFlow’ 
-Import ‘DelayedService’ 
-Import ‘RealtimeService’ 


El-25) Module 













: > Import 'DelayedService! 
[> Import 'Realtimeservice’ 





errr e 
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15. Click “Next >” to continue with the conversion: 


16. 


Page 13 





September 2013 





& 1, Select WebSphere ESE projects >» ef 2. Configure WebSphere ESB resource options » 3. Configure global conversion options > 4. © 





‘Configure WebSphere ESB resource options. Filter resources by name or by using a wildcard character. 


WebSphere ESB Resources: 


type filter text Select the XML maps that you want to convert. Double-cick on one map to see information on its usage analysis. 


DelayedToSteckQuoteService_res_i.map -xslt/Delay... StockQuote_MediationFlow.component 
Lookup_req_i.map - xslt/Lookup_req_i.map StockQuote_MedistionFlow component 
RealtimeToStockQuoteService_res_i.map - xslt/Realti... StockQuote_MediationFlow component 
ica] TransformToDelayed_req_i.map - xsit/TransformToD... StockQuote_MediationFlow.component 
[© TransformToRealTime_req_i.map - xslt/TransformTo... | StockQuote_MediationFlow .component 


Component 'StockQuote_MediationFlow' 
~~ [> Import 'DelayedService’ 


All selected WebSphere ESB XML maps will be converted to IBM Integration ® 
maps_ 











In this section you will find a summarized view of the original component and the conversion 


destination component: 





of 1, Select WebSphere ESB projects > ef 2. Configure WebSphere ESB resource options »+ ¢f 3. Configure global conversion options > 4. Convert WebSphere ESB resources > 





Configure global conversion options. Add extensions for those resources for which you want to use your own conversion code. 


¥ Conversion Result 
Specify how the conversion result should be recorded. 


D0 Merge new conversion results with the results from previous runs of this conversion session 

¥ Mediation Primitive Converters 

Each mediation primitive will be converted to a message flow node or subflow. You can supply your own converter to convert mediation primitives. Double-click on one mediation primitive to see 
information on its usage analysis. 


Request (for example SOAPRequest) 
Request (for example SOAPRequest) 
Subfiow placeholder 

Subfiow placeholder 

Input 

Reply (for example SOAPReply) 


.. JavaCompute 


~ Export and Import Binding Converters 


Tey MediationFlow.component 
StockQuote_MediationFlow.component 


Built-in converter 
Built-in converter 


StockQuote_MediationFlow.component Placeholder converter 


StockQuote_MediationFlow.component 
StockQuote_MediationFlow.component 
StockQuote_MediationFlow.component 
StockQuote_MediationFlow.component 
StackAunts MadistinnElam camnanent 


Placeholder converter 
Built-in converter 
Built-in converter 
Built-in converter 


Builtin camwvertar 


Each export or import binding will be converted to a message flow node or subfiow. You can supply your own converter to convert an export or import binding. Double-click on one export or import 
binding to see information on its usage analysis. 


TaN ETE import,RealtimeServ... _com.ibm.etools.mft.conversion.esb.extension. binding. Ja.. 
StockQuoteService.export FS Sr ope EES apa aaa ey 


pre Import 
WebService Export SOAPInput 











<Previous 
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17. Each mediation primitive will be converted to a message flow node or subflow. You can also 
create a new converter class, which allows you to create custom nodes or subflows for each 


18. 
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primitive. 


Reg 


* Mediation Primitive Converters 


Each mediation primitive will be converted to a message omg node or subflow. You can supply your own converter to convert mediato! 
mediation primitive to see information on its u: 





Sub 


tow placeholder 











Subj 

Input 

Reply (for example SOAPReply) 
» JavaCompute 


Droito 


How placeholder 


~ Export and Import Binding Converters 


Request (for example SOAPRequest) eedtiad 4 MediationFlow.component 
uest (for example SOAPRequest) StockQuote_MediationFlow. component 


StockQuote_MediationFlow.component 
StockQuote_MediationFlow.component 
StockQuote_MediationFlaw. component 
StockQuote_MediationFlow.component 
StockQuote_MediationFlow.component 


CtraddTintos Moria tanelee camennnomt 





Builtin conver ter 
Builtin conver ter 
Placeholder converter 
Placeholder converter 
Built4n converter 
Builtin conver ter 
Built4n conver ter 


Baaltan eamweor tor 


You will see several “Built-in converter’ classes. These classes will convert the imported 
WESB item into the equivalent component in Integration Bus. 


This means the converter will use prebuilt template classes to make those conversions. 


can supply your own converter to convert mediation primitives. Doub 


Bui 
Bui 
Pla 








[tn converter 
[tin converter 
ceholder converter 


ceholder converter 


tin converter 
Bui 
Bui 


Bui 


It4n converter 


itn converter 


[tin eeenortor 
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19. If anitem has a “Placeholder converter’, then you can define your own conversion 
extension using the Java Integration API for IIB. 


In this example, find the “MessageLogger” item. You will see the converter class is a 
“Placeholder converter”. Click (...) button on the “Placeholder converter” row to create a new 


converter Java class. 


‘ou can supply your awn converter to convert mediation primitives. Double-click on the 'Usage' column of a 


ediationFlow.component  Built-n converter 
ediationFlow.component Built-in converter 
e@diationFlow.componenpRacsholdencoowuantay 
edatonFiom.cmponerg Placeholder cower 
ediationFlow.component — Troonver te 

ediatonFlow.component  Built4n converter 

ediationFlow.component Built-in converter 


adistonFlea camnanant  Puilbin camvortor 


ow. You can supply your own converter bo convert an export or import binding. Double-dick on the 'Usage" 





20. The Converter Class editor window will open. Click “Create...” to create a new extension 
class for this conversion: 


19 Select Converter Class xi 


Lo | concet_| 
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21. Click “Create...” button to create a new project to hold your new java class. 





10) x! 


Java Project 


Select or create a new Java project. This project will contain your converter Java classes. 











22. Set the Project Name to “CustomExtension”, and click Finish. 


CT icix 


Project — 


Create a new project resource. La 








IV Use default location 


Location: | C: \workspaces\IBWorkshop \CustomExtension 








(Working sets 
T” Add project to working sets 


Working sets; 4 | 
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23. Click the “Next” button to create the class. 


Java Project 


Select or create a new Java project. This project will contain your converter Java dasses. 










: |CustomExtension 





(?) = Back Next > Finish | Cancel 


24. Set the class name to “TraceCustomExtension”. Ignore the warning about the default 
package. Click Finish. 


Java Compute Node Class 
{My The use of the default package is discouraged. 





Source folder: | CustomExtension/src Browse... | 
Package: | (default) Browse... | 
J” Endosing type: j Browse,,, 














Name: 
Modifiers: * public default private protected 
Jo abstract [7 final J static 
Superclass; com.ibm.etools.mft.conversion.esb.extensionpoint. AbstractMedi: BraWwse,,, 
Interfaces: 
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25. Click OK to complete the creation of the new class. 


19 Select Converter Class x! 


Choose a Java class which extends AbstractMediationPrimitiveConverter. For an example of how to create a user-defined 
converter class, see WebSphere ESB user-defined converters sample. 


Converter Java dass | TraceCustomExtension Select... | [Create... ] Reset to default | 


26. 
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«| concet_| 





This will open a Java editor with the template Java code. 


You will see a template class to create a flow using the Java API for IIB. 


For this lab, we have provided the java code for you. 
Open the file C:\student\WESB_Conversion\resources\TraceCustomExtension.txt. 


Copy the entire contents of this file into the Java editor, ensuring that all the current code in 


the Java editor is deleted first. 


(Fl =wesaconvsessioni.conversion {493 CustomExtension 





“import com.ibm.broker.config.appdev.Terminal; 
import com.ibm.etools.mft.conversion.esb.extensionpoint .AbstractMediationPrimitiveConvertey 
import com.ibm.etools.mft.conversion.esb.extensionpoint .Nodes; 
import com.ibm.broker.config.appdev.nodes.TraceNode; 





al] TraceCustomExtension.bct - Notepad 
public class TraceCustomExtension | File Egit Format View Help 





fimport 
S public String getConvertedTo()| import 
// TODO Provid&&jnformatiq]1 
// The String retiSged hey 
// in the "Configure Wloba 
// For example, "Trace”™ Wg 
return "To do by user"; 
} 


S GOverride| 
public String getType() { 
return "MessageLogger"; 
} 


a @Override 
public Nodes convert (Convertey 
Nodes nodes = createNodes { 
String nodeName = getPropd 


com. ibm. broker. config. appdev. Terminal; 

com. ibm. etools.mft. conversion. esb. extensionpoint. AbstractMedia 
com. ibm. etools.mft. conversion. esb. extensionpoint. Nodes; 

com. ibm. broker. config. appdev. nodes. TraceNnode; 


class TraceCustomextension extends AbstractmediationPrimitive 


public String getconvertedto() { 
} return "To do by user"; 


@override 
public string getType() { 
} return "MessageLogger"; 


G@override 

public Nodes convert(Convertercontext convertercontext) throw, 
Nodes nodes = createNodes(convertercontext); 
String nodeName = getProposedIIBNodeNameFromSour cePri 


TraceNode node = (TraceNode) createNode(converterco 
node. setDestination(Tracenode. ENUM_TRACE_DESTINATIG 
node. setPattern("Message passed through with the fd 
nodes. addNode(ROLE_MAIN, node); 


return nodes; 
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27. 


28. 
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The copied code uses the Integration API to create a new node in the converted flow. 
Review “convert(ConverterContext converterContext)” method of the class. This method 
creates a TraceNode for the logging of the transaction. 

Various node properties are also set with the java code. Take a few minutes to examine the 
java code, and observe how it creates, configures and connects the new node. 





@Override 
public Nodes convert (ConverterConteat converterContext) throws Exception {i 
Nodes nodes = createNodes(converterContext); 
String nodeName = getProposedlisNodeNameFromSourcePrimitive (convertercontesxt) ; 


TraceNode node = (IraceNode) createNode(converterContext .targetFlow, nodeName, ROLE MAIN, TraceNode.class, nodes): 
node .setDestination (TraceNode.ENUM TRACE DESTINATION.localError); 


node.getPattern("Megsage passed through with the following fields: Bodyeontent ig SiBody} Date S{CURRENT_ TIMESTAMP? ") 
nodes.addNode (ROLE_MAIN, node); 





return nodes; 








Save (Crtl+s). Close the “CustomExtension” tab and “TraceCustomExtension.java” Java 
editor. 


Return to “WESBConvSession1.conversion’” tab. 


Review the converter class for the “MessageLogger” mediation primitive. It should now be 
set to “TraceCustomExtension’. 


pply your own converter to convert mediation primitives. Double-cick on the ‘Usage’ column of; 


bw.component Placeholder converter 
bw.component Built-in converter 
bw.component  Builtjn converter 
bv. component Built-in converter 


bw. component Tver Le 
bv. component jl raceCustomExtension 


bw. component 





Click “Next” link to continue. 
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29. Asummary for the conversion scenario will appear. Review the summary: 


Revew the configuraion details for this conversion scssion. Stert the conversion of your Web£phere =58 resources. Double dick on a map cntry to verify the list of maps that arc sclectcd 


Summary of the conversion configuraion: 


XML Mare to comert xelt/TrareformT2Reallme_reg_imao,xclt/ransformTol§.. 
Merge conversion result 
Mediation piimil... © Gormver ler TraceCuslomEx sensu 





30. Click “Start conversion...” in the bottom of the summary to start the conversion process: 


< Previous 





This process should take less than a minute. 
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31. 
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After the conversion process is complete, review the conversion results and check the 
resulting IIB projects. 


Review the conversion reculte. Complete all the to-do tas<e to firich converting WebSphere ESB resources. 


{ Show al €° Show resources with incomplete tasks 









— | Canversion summary 
3 All todo tasks 
& al preblems i in the converted projects 


Suite 


Mapping b 
Integration: 











& Uh s Source: Resources 
E BA Converted to:TIB_Resources 
fg DelayedService_InlireSchema 1.xsd - /TIB_Resources/DelayedService_InlineSchema1.xsd 
[5] RealtmeService_InlineSchema 1L.xsd - /IIB_Resources/ReatimeService_InineSchema 1.xed 
[5] StockQuoteService_InlineScema L.«sd - /UB_Rescurces/StockQuoteService_InlineSchema 1.xs¢ 
£2 DelayedService.wsdl - /IIB_Resources/DelayedService. wsdl 
2 RealtmeService.wsd - (IB_Resources/RealtimeService. wadl 
@ StockQuoteservice. wsdl - (IB_Resources/StockQuoteservice. wsdl 
2 StockQuoteService_StockQuoteServiceHttp_Service.wsdl - IB_Resources/StockQuoteService_StockQ 
2? StockQuote_DelayedServicePortTypelmporti.wadl - [[petsources/StocxQuote_DelayedServicePortT: 
22 StockQuote_2ealtimeServicePortTypelmport + JIIB_2esources/StockQuote_RealtineServicePort] 
=] @ Source: StockQuote 
E [3] Converted to:TIB_StockQuote 
NelayedToS tock ine Service _res_|.map - /TTR_Stock(uinte/welt MelayedoStockQunteservice _res_1.4 
Lookup_req_i.map - /TIB_StockQuote/xsit/_ookup req_i.nap 
RealtmeToStockQuoteService res Lmap - /IIB StockQucte/xsltRealtimeToStockQuoteService res 1 
TransformToDelayec_req_imap - (IB_StockQuote/xslt/TansformToDelayed_req_i.mep 
TransformToReallim=_req_i.map - /TIB_SteckQuoce/xsit/ransformToRealTime req _i.map 
ea TIB_StockQuote.msoflow - [1B StockQuote/IIB_StockQuote.msaflow 
Ela StockQuote_MediationFlow_getQuote_Request_Response.subflow - [IB_StockQuote/gen/StockQuote 
E = Converted to:TIB_StockQuoteleva 
Bp StockQuote_MediationFlow_getQuote_Request_Response_SetCustomerType. java - /TIE StockQuotel 
Bi StockQuote_MediationFlow_getQuote Request Response _SetQualityOfService.java - (IB StockQuot 



























fe qd thd (ey) 
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32. You can also see a mapping or equivalent table between the WebSphere ESB files and 
Integration Bus files, by clicking on the conversion summary item on the left panel: 


f* Show all © Showresources with incomplete tasks 


—| Conversion summary 


{Al to-dn tasks 


€ Al problems in the converted projects 
Detailed conversion results 


i m gource: Resources 


El 


“Mapping between WebSphere ESB files and Integration Bus files 


Mapping between WebSphere ESB files and Integration Bus files 








WebSphere ESB files 


Integration Bus files 




















: DelayedService.wsdl 
DelayedService. weil DelayedService_InlineSchema1.xsd 
’ ‘ RealtimeService.wsdl 
RENESeI vice wa RealtimeService_InlineSchema1.xsd 
StockQuoteRequest.xsd StockQuoteRequest.xsd 
StockQuoteResponse.xsd StockQuoteResponse.xsd 
StockQuoteService.wsdl Sa saan eaaaate 


StockQuoteService_InlineSchema1_.xsd 





StockQuoteService_StockQuoteServiceHttp_Service.wsdl 


StockQuoteService_StockQuoteServiceHttp_Service.wsdl 





StockQuote_DelayedServicePortTypeimport wsdl 


StockQuote_DelayedServicePortT ypelmport1 wsdl 





StockQuote_RealtimeServicePortTypelmportt wsdl 


StockQuote_RealtimeServicePortTypeimport1 wsdl 





Subscriptioninformation.xsd 


Subscriptioninformation.xsd 








DelayedService.import 


gen/StockQuote_MediationFlow_getQuote_request.subflow 





RealtimeService.import 


gen/StockQuote_MediationFlow_getQuote_request.subflow 





StockQuoteService.export 


IIB_StockQuote.msgflow 





StockQuote_MediationFlow.component 


StockQuote_MediationFlow_getQuote_request_SetCustomerType java 
StockQuote_MediationFlow_getQuote_request_SetQualityOfService java 





StockQuote_MediationFlow.mfc 


StockQuote_MediationFlow. | getQuote_request/StockQuote_MediationFlow. |_getQu 
StockQuote_MediationFlow_getQuote_request/StockQuote_MediationFlow_getQu 
gen/StockQuote_MediationFlow_getQuote_request.subflow 





sca.module 


IIB_StockQuote.msgflow 





xslt/DelayedToStockQuoteService_res_1.map 


xsit/DelayedToStockQuoteService_res_1.map 





xsi/Lookup_req_1.map 


xsi/Lookup_req_1.map 











xsi/Realtime ToStockQuoteService_res_1.map 
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33. Select “All problems in the converted projects”. 


As you can see there are some warnings that you will fix in the next section of this lab. 


Revew the conversion results. Complct: al the te do tesks te finish converting W=bSpherc ESB resources. 







( show all ( Show resources with Inconplete tasks 


or ne 


§ All -0-do tacke 


& The import javax.oml.bind. JAXBExcesticn is never used 





% All problems in the « ried projects & he import org.wie.dom.Document is never used 
E Detailed conversion results & The import com.ibm.broker plugin MEXM_NSC Is never used 
i w Source: Rescurces & The import javax.xm.bind. JAXBExceoticn is never used 
=] BA Converted to:TIB_Resources & The import org.w3c.dom.Document is never used 
[S| DelayedService InlineScemai.xsd - & The import com. itm. broker plugin MEXM_NSC is never used 


(5) RealtimeService_Talin=Schema xsd - & Innit node "Trp? is uncannected 

£ StockQuoteService_InlinsSchemai.xe & The implementation 'zer/IIB_Stoc<QuotelnputFailuretandler.cubfow contains only Inpu: and Outputnodes 

28 DelayedService.wsdl - MID_Resources & Input node ‘Input is unconnected 

£@ RealtmeService. wsdl - (1B_Resource: & The implementation ‘Jer /11B_StoccQuoteInputHT1PTmeoutdandler.subfiow contains only Inpu: and Gutputnodes 
(28 StockQuoteService.wedl - /IIB_Resour & Input node ‘Input is unconnected 

£8 StockQuoteService_StockQuoteServic & The implementation 'jer/IIB_StoccQuoteInputCatthHandler.subflow' cortains only Input and Output nodes 

(28 StodQuote_DelayedServicePortTvpel 
28 SinckQunte_RealtimeServicePertType 

El © source: stockQuote Message | The impor Ujevex xnd.bind JAXBE<cesliun is never used 
C1 3] Converted t:1ID_StockQuote - 

I} Delayedrostockquoteservice_-es_Lt Resource | StockQuote_MedationFow_getQuot=_Request_Response_Se-Customerl ype.zava 
[& Lookup_req_i.mao - /IIB_SockQuote Path /0B_StockQuote Java/SiockQuote_MediationFilow_getQuote_Reques=_Response_SetCustomerlype.jave 
{& RealtimeToStockQuoteService_res_1 
& TransformT2Delayed_reg_i.map - /IE 
{ TransformTaRealTime_rea_t.rap - fll 


querer sips } 








34. Review the suggested tasks to solve some of these warnings by clicking “All to-do tasks”: 
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Review the conversion results. Conpicte all the to de tasks i Jnish converting WebSphere ESB resourccs. 









@ Shewal © Show resources with incemolete tasks 


The Message Flenent Setter mediacicn primitive ‘SecC istomerTyne" has heen converted to the TavaCompure nod> Setl 
lhe Message Henent Setter medaicn pnmitve ‘se7Customer| ype’ co7tains an unsupported message element Jeth ‘jcon’ 
Update nzp 'Delay=cToStockQuoteService_res_i.map' to use X°2tb 2.0, [or mere information, see Completing a to-do te 
Fix env vaidaton errors ard warnings for map ‘/T3B_StockQuote/wsl-/DeavedToStoccQuatetervize_res_i.map'. Toresoh. 
Urdate nap TransforToRealTime_req_i.nap' to use XPath 2.0. For nore infornatior, see Completing a to-de task “or & 
Fix any valdaton errors ard warnings for map ‘/16_StockQuote/xsi-/TransformToReallime_req_.map’. To resolve valid: 
Update map 'Leowp_req_i.mao' to usc XPath 2.0. =er more information, sc> Cemalcting c to do task for XPath 1.0 cxpré 
The nap contains a leocup trareforn defined between an inact ard outpur element where one o* hem is a context eeme 
Urdate nep TranstomToCelayed "eq imap’ to use XPath 2 0. For more irfermaticn, see Completing a tc-co task tor XF 
Fia ery veidalon errors ard warnings for map '06_SluckQuule/xsl_/TrarsformTuDelayed_rey_2.may'. Tu resulve valida: 
The orginal end poin: cf the import LelayedSarvice ie "htip://example.com'. On rede ‘DelayedService’, confirm tha: tiie ie 
The arninsl and nain- cf tha inert 'DesltmaGeniire! ie ‘hin Jievsnnle 






















3S RealtmeService_Irlinescema L.xsd 
© StoccQuotefervice_InlineSchenaiwx 
239 DelayedSe-vice.wedl - {T1B_Resource 
2 Realtimeservice.wsdl - IB Resour 
2 swuQuuleservice. wsdl - (IB_R 
2D StoccQuoteService_StockQuoteServi 
29 StoceQuinte_NelayerBervicePartTypd 
@ Stocc(uote_Reatmeservicerortl ype 
O @& scurce: StockQuote 
& SS) Converted to:IIB_StecQuot= 
{& DelayedToStockQuotese-vice_ses_1.- 
{3} Lookup_req_t.map - 11B_Stockquote 
= RealtimeTcSzodeQuoceService_res_ia 
{& Transforn7eDeleyed_rsq_i.map - (TE 
{& Transtorm7oReaTine eq imap -/0 
BE 0B_StexQuale-msy Tew - (B_Slu-k! 
Ela StoccQuote_MsciaticnFlow_ge-Quote 










2 0D 0 0 OD OH DHE OH OD OND 


' On nads Desltimefervics' canfem tist the 
























The Vessage =lement Setter mediation primitive SetCustomerlype hes beer convertec to tre 
vavaCompute ncde “Se:Customerl ype’. Manually convet the actions from the Messeg2 C ement Secter 
primitive into Java code in che JavaCompure node “SetTustomerType’. 














¥cu use a JavaCcmpute nade to check and manipulate message cortent. For mors informetion or the 
wavaComoaute ncde_ ses JavaCompute node 












To learn about developing ard writing Java code in IBM nzegration Bus, see Deve oping Java_ 











To learn how to associat> Java code witi your JevaCompute node, see Creating wave code fora 


Save the “WESBConvSession1.conversion” (Crtl+s) and close it. 
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3. Update the Generated StockQuote Service 


1. Check the generated services and projects. 


The first thing to note is that the conversion process has created an Integration Service called 
IIB_StockQuote. Expand the IIB_StockQuote Service and the IIB_Resources library. 


In the IIB_StockQuote service, expand the Resources folder. You will see the generated Flows, 
subflows, mappings and other resources created by the conversion wizard: 





[Apeeaor Development, £2) Bl Patter Elor] 
| Application Development 


| G35) UB _StockQuote 
| e-FE) Integration Service Description 
= E82 cetQuote 


i E RequesL_Respurse 
Ao 





2hg TIB_StockQuotelnputCatchHandler.subflow 
Eg TB StockQuotelnputFailreHander sunfiow 
lg TIB_StockQuoteinputhT PTimeoutHandler subfow 
' Els StockQuote_MediationMow_getQuote_request.subflow 
“4% Stockjuote_MedabonHow_getguote_request 
: lg StocQuote tockQuoteFai 


= time StockOuoter ail 


= Lookup_reg_i.map 
Realhm=TaSinckQiintServee_res_1omap 
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2. You will now perform some final conversion tasks that could not be done automatically. 


Open the generated Integration Service: “IBM_StockQuote” > Integration Service Description: 


IIB_StockQuote F 


El5] 1B_StockQuo IIB_StockQuote 
it RIO He i) SOAP/HTTP @ getQuote 





[x] Error Handlers 
: Ps Catch 
ca) WESB_Resources i 
ee Independent Resources L = Failure 
)-lEs#] WebSphere ESB Projects ee 





3. Click the “getQuote” link: 
EI IIB StockQuote #9 


IIB_StockQuote (I) StockQuoteService 


Error Handlers 
“Sig Catch 

Failure 

“ag Timeout 
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4. This will take you to the generated Stock_MediationFlow_getQuote_request.subflow. Note that 
the position of the node icons in your generated subflow may appear slightly different from those 








shown below. 
5. 14, 
2. 4. wi 2 wo) Eg 
Pe P| 52 SetCustomerType 8. RealtimeStockQuoteFail 
ra \ Filter | ¢ 3? 
\ | RealtimeService = 13. 
1. 3. “bp >| & 15. 
ED} be 6./ RealtmeService SOAPExtract RealtimeToStockQuoteSérvice j 
= * 
StockQuoteService_getQuote_Input Lookup \ }| = 11. 
\, TransformToReatTime = {Pera ee 
x2) Bg 7 
\ 2. DelayedStockQuoteFail >| 
\ as 33 SetQualityOfService 
7. DelayedService 
Vi a 10 
‘<8 ———-o] = 
TransformToDelayed 
DelayedService SOAPExtract _pelayedTostockQuoteService 
alent so they have been 








Note that some converted components have no native conversion equiv 
converted to the most similar node available. 
Actual StockQuote application sample mediation module for WESB: 


8. 
> tb» (©) DelayedServicePortTypePartner 


# getQuote 


9. 
o> ap RealtimeServicePortTypePartner 
¥ getQuote 
> I} | @ StockQuoteService 
¥ getQuote 
ald (Z) StockQuoteService 


¥ getQuote 


2. 4. 5. 
ai rs 
M 
Log aI 
SetCustomerType 
Filter 
1. 3. 
@) StockQuoteService I> & o > 
4g = 6. 
getQuote 
>. 
Lookup 7] 
TransformToDelayed 
7. 
> > 
E 
‘a 
TransformToRealTime 
10. 
- ; De D> 
DelayedServicePortTypePartner po) hs 
%@ getQuote DelayedToStockQuot... 
11. 
t] 15. 
: 12. 
DelayedStockQuoteFail = > 
M 
SetQualityOfService 
13. 
o > 
E 
o 2 


RealtimeServicePortTypePartner 
yp 
¥ getQuote 


RealtimeToStockQuo... 
14. 

0 

° 


RealtimeStockQuoteF... 
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5. Expand the “IIB_ Resources” library. In Schema Definitions, expand “http://Resources”, and open 
SubscriptionInformation.xsd. 


Eh TIB_Resources 
Bs Schema Definitions 
ie BR (default namespace) 
B AR http: //Resources 
- [S| StockQuoteRequest. xsd 
[s) eneeeanes xed 


[a ~ http: ie tlaes eee) 
ie BR http: //StockQuoteProvider /DelayedService/ 
ese http: //StockQuoteProvider /RealtimeService/ 
ie iB http: /www.w3.org/XML/1998,/namespace 

+) WSDL Definitions 





6. The SubscriptionInformation schema does not have any elements defined yet. This is because it 
was not exported as a complex business object. You are going to create a string element for the 
SubscriptionLevel schema. 


In the “Elements” white space, right-click and select “Add Element”. Name the new element 
“sublevel”. 


This element will be used later with the LocalEnvironment to keep correlation information as the 
message passes through the flow. (Note, you can choose to use alternative methods to store 
correlation information; we are just using the Local Environment as a simple illustration of possible 
techniques). 

Save the schema. 


‘GE B_StockQuote.msgf {ls StockQuote Mediation —{/2 Lookup_req_1 


[s) Schema : http://Resources 






































View: Advanced ~ (2) 





5 Directives 


[€] sublevel : string — SubscriptionInformation 


| Gi Add Element 














Page 27 WESB conversion feature with Stock Quote (sample application) Version 9.0.0.0.1 
Provided by IBM BetaWorks 


IBM Integration Bus v9.0 Workshop September 2013 





7. In the Application Development view go to IIB_StockQuote> Integration Service Description > 
getQuote > Request_Response. Open it. 


gal By ti 


etal TIB_StockQuote 
See Integration Service Description , a 


BS Resources 
ar Flows 
:EHE] TTB StockQuote.msafiow 


ra Gey Sub flows 





Remember this will take you to the Stock_MediationFlow_getQuote_request.subflow where you 
can find the actual mediation logic for this flow. 


First, review the “Log” node (which is an Integration Bus Trace Node). This is the node that was 
generated by the Customer Extension java code, using the Integration API. 





| (2) TraceCustomExtension.java 


TraceNode node = (TraceNode) createNode(converterContext.targetFlow, nodeName, ROLE_MAIN, 


node. setDestination (TraceNode.ENUM_TRACE_ DESTINATION. localError) ; 
node.setPattern("Message passed through with the following fields: Bodycontent is ${Body} 







F] AWESBConvSessioni.conversion | 4 Customxtension 


nodes.addNode (ROLE_MAIN, node); 








turn nodes; 








Properties £2 \. [2 Problems| 3 Outline | ) Tasks | Fl Sloyment Log) 

















‘J? Trace Node Properties - Log 


@, Destination: Depending on your operating sys y in your system log with this settin) 


log you may only get a single lin 








Description 
Basic Destination [Local Error Log 


Meir I 


— rile path 




















Pattern ‘Message passed through with the following fields: Bodycontent is ${Body} Date ${CURRENT_TIMEST, 
4 
Message catalog [ 
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9. Inthe next few steps you will work with the Mapping Node editor to complete the required 
mappings. Two primary tasks are required: 


e Customize the Lookup Mapping Node to read a Customer ID from a relational database 
table. As it was done in the original mediation flow. 

e Several Mapping Nodes will be customized to introduce the use of the Local Environment. 
As discussed above the LocalEnvironment is used as a convenient local storage area for 
correlation information (the sublevel item that was added to the schema). 


First, you will customize the Lookup Mapping Node to retrieve the customer subscription level 
information. Go to the “Lookup” node and double-click on the node to open it. 


Di wentervsesinierverson  (lipaieaiielieieiatimetiecemmatioaia 

















do Ge Palelic 
| Ae | rol yD 
iisGemiies StoccQuetese vice_getQuate_Input 0g 
(na WebSphere MQ 

(ms JMS 

CS web Services 

| ESCA 

(gi WebSphere Adapters 
(y)Reuting 

(55 Transformation 

(_@ Construction 
(fyvatebese 


a ee 





























10. In the original flow, the database lookup node was been used to retrieve Customer information from 
a DataBase file. The mapping node has the ability to query the data source to add this data to any 
part of the message tree. 


You will see a “Task” mapping, Delete the “Task” mapping, by right-clicking and delete or use the 
red “x” on the top. 








(Citeseeeeeeee [Gls StockQuote_MediationFlow_getQuote request.subfiow —_[[=: Lookup req 1 < 





[2 Lookup_req_i 
vlokupreqi “ Pi P| | XL SF S| BB EaH| F 








& [os Message Assembly getQuote =| [se Message Assembly getQuote 
> <Click to filter... > = <Click to filter... > 


#) pF! Properties [0..1] PropertiesType @ GB] Properties [0..1] PropertiesType 


\ @ &£) getQuote [1.1] <Anonymous> 





=) Fl getQuote [1..1] <Anonymous> 
= [2] request [1.1] StockQuoteRequest 
[e] symbol [0.-1] string 
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11. To get the subscription level of the Customer, the Mapping Node will query a table from the 
SAMPLE database, and store that information on the “LocalEnvironment” until it is needed again. 


To do this, you need to enable the LocalEnvironment to be accessed by the Mapping Node. Select 
the “Message Assembly” box of the input object: 


vLookup_req_1 P| fle) *| ef S| B is ee | 


=P <Click to filter... > 


() Pl Properties {0..4] | PropertiesType 


(=) EB] getQuote Anonymous > 











& [e) request StockQuoteRequest 


[e] symbol string | 


le] customerID [0..2] | string 








Click the link “Properties” on the “Properties” tab. 
12. Mark the “LocalEnvironment” checkbox and click “OK”. 


10 Add or Remove Headers and Folders #- T= x| 


No folders (map body element only) 
@ Selected headers and other folders 


























OE! Imstransport 
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13. Perform the same procedure for the output message. 


Now you will have a “LocalEnvironment” header for output Message Assembly. You will use this 
header to store the Subscription Level of the Customer: 


BS Lookup_req_1 











vLookup_req_1_. E PP | bi [ie | | = 
=) PLE Message Assembly getQuote 
= <Click to filter...> = <Click to filter... > 


SS = : 
@ dé] Properties [0..1] PropertiesType “EjMove + ©) A] LocalEnvironment 





Destination 


WrittenDestination 


——— 
@ df] getQuote [1.1] <Anonymous> “| Move ~ 








Aggregation 





DedsionServices 
HTP 

File 

SOAP 

5CA 




















Sequence 
TCPIP 








ServiceRegistry 











#] 
+) 
#) 
i) 
+) 
#) 
#) 
+) 
# 
i 
Ey 
# 





ServiceRegistryLookupProperties 





14. Create a variable in the LocalEnvironment to map the “sublevel” element previously defined. 
Expand “LocalEnvironment” on the output Assembly Message, expand Variables, and expand it to 
cast a new element: 











=] [s8 Message Assenhy gettuinte 
“Se <Click te fier... > 
( yf) LocalEnvirorment {0..4] _LocalEnvronmentl ype 
iH [@ Destinstion 76..1]  LocslEnvronmen®DestinatonT ype 
it) [2 Writerbestnaton [U..1] _LocalknvronmentyynttenUesination | yp= 
f [@ Aggregation [0..1]  _LocalEnvronmentAggregationT ype 
 [& DedsionServices [0..1] _LocalEnvronmenDedsionServices ype 
f [& HP (0.4) _localEwionmentTTPT ype 
ff [@ Fie 0..1]) ocalFrvronment@ileType 
fH [e S0A> [0..2) _LocalEnvronmentSOAPT ype 
fy [@ SCA [0..1) _LocalEnvrenmentSCAT ype 
 [@ Sequerce [0.1] LocalEnvronmentSequenceT ype 
fe iver [0..1] _Localrnvronmenti Cir | ype 
) [@ ServiceRegiery [0.4] _LocslEnvironmentseryygé 
fe ServiceRegisry_ookupProperties = [0.1] _LocalEnvronmengfrviceRegstryLookupType 
[= Adapter 
[e Wildrard 
=] [€ Variables 
[0.0] _LocalEnvronmentcICstType 








Click “any” and the “Cast” icon will appear. Click the Cast icon. (You can also right-click on the 
“any” line, and select cast from the Context Menu if the hover icon does not appear). 
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15. Select “sublevel” and click “OK” 


[ typeselecton TT 


Choose a type (? = any character, * = any string): 


Envelope 
Fault 
getQuote 








16. Nowcreate a select statement to retrieve the customer information from the SAMPLE database. 


Click the “Select rows from a database” icon: 












































{& Lookup_req_1 
vLookup_req i | be] |# $s fq fe 65 | BS 
=| nes Message Assembly getQuote = [ee Message Assembly getQuo 
%: <Clice to filter...> 2% <Clicc to filter...> 
@ gf! Properties (0..1] PropertiesType ___ gMove~ | = af] Lecalenvironment (0..d] _Localen 
[ ~~ oe. er ; Be Moves  [@] Destination [0..1] _LocalEn: 
Hl aF! getQuote [1.1] <Anonymous> cease Bcaisst Mi taee 
@ [€] WrittenDestination 0..1]  _LocalEn 
 [€] Aggregation {0..1] 


A “New Database Select” dialog will pop. 











17. If there is no Database available in the dropdown menu of the “New Database Select” editor, you 
will need to add the database. Click on the “Add database...” link: 
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15 New Database Select 


Choose a database to select from 
There is no database available to project 










Define a where clause 


“TIB_StockQuote™, 
evaluate to a boolean. 
I Pa [scat] database... 
Table columns 
Choose the columns to include 


You must choose at least one column. 
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18. Select the SQSAMPLE database from the “Data design projects unavailable to the map” box and 
click “Make available’. 

















1B Add Database xi 
Add a database definition model file 


Choose a method to make a dbm file available to the map. A dbm file defines a data model. 


Import from a database 
Connect to a database and select a physical data model. 


Import... 
Import a data design project 


Import a data design project into the workspace. For example, you may obtain a data model by importing a project interchange or 
getting a project from a repository. 


Import... 


Make a data design project available from the map 
Some data models may reside in projects that are currently unavailal ‘om the map. Select a project from the list below to make it 


available. 
Data design projects unavailable to the map Data design projects available to the map 


Make available > 
Make all available >> 





Make SQSAMPLE is now on the “Data design projects available to the map” box. Click “OK” 
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19. To build the SELECT expression for this task, complete the following steps: 











1. Select the SAMPLE database from the drop-down menu. 
2. Expand the SCUSTOMER table. Select only the “SUBLEVEL’. 
3. Delete the “1=1” default expression in the “SQL where clause” box. 
4. Goto “Table columns”. Expand IIBADMIN > SCUSTOMER. Double-click CUSTOMERID. 
5. Review “SQL where clause” is “IIBADMIN.SCUSTOMER.CUSTOMERID”. 
19) New Database Select = Dx 
Choose a database to select from Define a where clause 
Select a database available to the map, or obtain a The where cause is used to extract only those rows that fulfill a specified condition, which is often the value of a 
different database. key column in the database table. The value can come from other inputs in the map. The expression must 
‘A. evaluate to a boolean. 
[oF Table columns Operators Available inputs for column values 
Choose the columns to include IIBADMIN 


























You \nust choose at least one column. 










































































SQL where dause 
5. IBADMIN.SCUSTOMER.CUSTOMERID} 




















1) GG) 














2. 


> Classify SQL warning 
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20. 6. Double-click on the operator. 
7. Go to “Available inputs for column values” box, Expand io:getQuote > request. Double-click 
customerlID. 
8. The “Place holder” that was generated for this expression refers to the customerID in the 
MessageAssembly. 


Choose a database to select from 
Select a database available to the map, or obtain a 


different database. 
[SAMPLE 7] Add database... 


Choose the columns to include 


You must choose at least one column. 



















































A 























TY) 





(OE empprojact 

OG act 

OE mn_tray 

OE ore 

OE stare 

OO sates 

OOS staFre 

OO ememoc 

(O& propuct 

OO & ventory 

OE customer 

(OE PuRCHASEORDER 

OE catatoc 

(OS supp.iers 

(1 & probuctsuppier 

FE ScUSTOMER 
~~] 8 CUSTOMERID 

8 SUBLEVEL 





> Classify SQL warning 


Define a where clause 

The where dause is used to extract only those rows that fulfill a specified condition, which is often the value of a 
key column in the database table. The value can come from other inputs in the map. The expression must 
evaluate to a boolean. 






Table columns 


























[aS $MessageAssembly 
+ of) LocalEnvironment 
+ ofl Properties 

ofl joy te 
(2) fequest 















































SQL where clause 








Make sure the expression on the “SQL where clause” box looks like this 


“IIBADMIN.SCUSTOMER.CUSTOMERID = ?” 


Also make sure that the XPath Expression look like this: 


$MessageAssembly/{hitp://Resources/StockQuoteService}:getQuote/request/customerID 


Click OK. 
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21. Connect the “Select” mapping to with the “sublevel” Variable you created a few steps before: 
© 2H Select from SAMPLE  [e] Aggregation [0.1] Local 
= <Glick to filter...>  [] DecisionServices [0..1] _Local 
a E@ ResultSet [D..4] Result SetRow eo [e] HTTP [9.1] _bocal 
. — - @ [e] File [0..1] _Local§ 
@ [e] SOAP [0..1] _Localg 
 [e] SCA [0..1] _Localy 
& [€] Sequence [0..1] _Localy 
& [e] TCPIP [0..1] _Locald 
fH [e] ServiceReaistry [0..1] _Local# 
+ Eel ServiceReaistryLookupProperties ‘b.0 _localf 
= Se es 
 [e] Wildcard [0..1] _Local 
[e] Variables [0..1] _Local§ 
ie] an 
fasted A at 
SS aS SSS eS Li 
22. Click the “Select” link on the mapping you have just connected: 
=) 2a] Select from SAMPLE = 
=> <Click to filter... > 
wo 5@ ResultSet [0..*] Result Set Row 
This will take you to a mapping editor for the “Select” result. 
23. Map the SUBLEVEL input from the “ResultSet” input to the “sublevel” variable on the output. You 
should now have something like this: 
[Lookup req_i > ig sublevel : string 
*Lookup_req_i wae pi | | [eo [ee | x | e 4 | fe 9S 23 | 
ae 
BS ResultSet [0..*] Result Set Row {ige sublevel {0..*]  siring | 
Pe <Click to filter... > 
Make sure the connection map is “Move”. 
Save and close the mapping Node. 
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24. Click the node named “Filter”. This node is actually a Route Node, and is a decision point for the 
flow. The value “sublevel” mapped on the previous step will be compared and used to route the 
message to the correct node. Go to the properties tab of the “Filter” node: 













































fa WESBConvSessionLcon {G210B StockOustemsai «Els StockQuoce_Mediation 2 ~\_ 8) Subscriptioninformat [5 Lookua_req_1 } = = 3 
b rj 
z 

——— 2 3 

Ae SetCustorerT}pe E 

} ‘ i] 2 

/ \ Nofe BL 9 fg : 

i \, | = or = 

TransfornTcRealTime Realtmefervice RealtmeStockQuote=ail i 
kkQuoteService_getuote_! ‘. mo Es 
«| a Bs 
Graph | User A 
+ 

Properties £3» [£. Problems| B& Ostiire | | Tascs | El Depioynert Log Pie 
2m Route Node Properties - Filter t 
aa i 
Neserpticn Fs 
Basic ier bat Auld... (f 
Monitoring . Fa 
Delete [2 

















As the original StockQuote uses a different way to compare the Subscription Level, you have to 
change the filter to use the data from the defined message domains. 


Select the first row of the “Filter Table” (the one routing to the “realtime” output terminal), and click 
the “Edit...” button. 


In Windows Explorer, go to c:\student\WESB_Conversion\resources and open the 
file\XPathExpressions.txt 


25. The “Edit Filter table entry” option will open: 


1D Edit Filter table entry x} 


Filter pattern* 
[Icontext/correlation /subscriptionLevel ='premium' Edit... | 
Routing output terminal 


[realtime ¥ 


Lo] concet_| 
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26. Clear the “Filter pattern” 





10 Edit Filter table entry | 


| 














27. Copy the value (“ $LocalEnvironment /Variables/sub:sublevel='premium' “) from the 
text file and paste it on the “Filter pattern” box: 


|B Edit Filter table entry g | 























e) XPathExpressions.bct - Notepad 


######xXPath ExpressionyY for Mapping Nodes######### 


$LocalEnvironment/Variables/sub:sublevel='regular' 
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28. Make sure that the filter for ‘premium’ is set to the “Routing output terminal” realtime: 


1D Edit Filter table entry x! 


Filter pattern* 





zalEnvironment/Variables/sub:sublevel=feumuy Edit... | 





Do not click OK at this point. 
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29. The “sub” namespace reference by this XPath expression does not have an associated URI, so this 
needs to be created. 


In the Edit Filter window (above) click the Edit button. This will open the XPath Expression builder. 


Expand the Namespace settings, and click Add. In the dialogue window, set the Prefix to “sub”, and 
the namespace to http://resources. 


Click OK, then Finish, then OK to return to the flow editor. 


(8 xPath Expression Builder > 15) x| 


Path Expression Builder 
Select the target from the Schema viewer, Function viewer or Operator viewer and drag and drop the nodes in the 
source viewer below. 




















































































Data Types Viewer XPath Functions 

=|) Data Types Lx} String 
+]-G9= SRoot #]~-(% Boolean 
~~ O9* $Properties (4 Numeric 
+)-09= $LocalEnvironment #]-CB) NodeSet 
»~G9= $DestinationList Ho Axes 

60 SExceptionList 

}-0)= $Environment {9 Add prefix and namespace map entry 


$3 (Add Data Type ... 
se eRe) Prefix: sub 


Namespace: | http://Rbsources 








CO Show XML Schema groups 
Path Expression 


Cancel 
[ SLocalEnvironment/Variables/sub:sublevel=', Lx | __ Cancel | 






yl Delete 


® ae] _ coms 


The namespace will be created like this: 





sub http://Resources 
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30. Repeat the previous steps with the next row (delayedTime terminal). (Use the string you copied into 
the clipboard here. Change the ‘premium’ to ‘regular’). 


You should have the filter table set like this: 


Iter table* 


i = pr 
SLocalEnvironment/Variables/sub:sublevel="regular'’ delayedTime 





Save the filter. (Ctrl+s). 


31. The original StockQuote application consumes the actual quote value from an application hosted 
on the WESB runtime. For this lab you are going to use an existing application running in 
WebSphere Application Server to obtain this quote value. 


Find the “RealTime” and “DelayedService” SOAP Request Nodes (both converted from callouts to 
SOAP Request): 














——s.| Bs 
RealtineService J ~_—_-RealmeStockQuoteFail 
_ SS Das | = Lee 
RealtimeService_SOAPExtract Realtim=ToStockQuoteService 









ie > Bg 


DeleyedStockQuoteFail 
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32. These nodes will invoke a StockQuote web service to get the actual value of the quote, so you 
need to import some WSDL and XSD definitions into the IIB_ Resources library. Highlight the 
library, then click File > Import... 


Under General, select “Archive File”. Click “Next...” 


=iolx! 
Select 
ps 7 
Import resources from an archive file into an existing project. 








(& Decision Services 


-& EIB 

@ Java Ee 

[1 Modeling 

(© Plug-in Development 








33. Browse for: C:\student\WESB_Conversion\resources\WSDL_Resources.zip. In the archive file 


selector, highlight wsdISM and make sure all the three files are selected. Place the files into 
“IIB_Resources’: 


lolx) 
Archive file tT 
Import the contents of an archive file in zip or tar format from the local file system. \ | 
aS 





From archive file: | C:\student\WESB_Conversion\yesources\WSDL_Resources.zip | Browse... | 


|X) StockQuote_InlineSchema1.xsd 
[x] StockQuote.wsdl 
|X] StockQuote.xsd 
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Click Finish. 


34. Inthe IIB_Resources library, expand WSDL Definitions and http://sq.betaworks.ibm.com. 


Drag and drop the “StockQuote.wsdl” onto each SOAP Request Node. 




























Application Development New. 


AS] TIB_StockQuote 
lB, TIB_Resources 

: EES Schema Definitions 
. EG WSDL Definitions 

: EB htto://Resources/StockQuotese: 
| EER http://sq.betaworks. ibm, com 


ee ——a 


ae RealtimeStockQuoteFail 






ay 1 (eye 


ae \ RealtimeService_SOAPExtad 


\ a 
', 




















Save the updated flow. 


35. Open the “RealtimeToStockQuoteService” mapping node. Delete the input Message Assembly. 
Select “Message Assembly” and click the “Delete selected elements” (red “X”) icon: 


[= RealtimeToStockQuoteService_res_1 











*RealtimeToStockQuoteService_res_1_/ 














IEnwironmentT ype 





f#) EE! Properties [0..1) | Proper tiesType 


gel getqQuoteResponse [1.1] | <Anonymous> 


[Lut] | oat 
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36. Click the “Add an input object” icon: 


[= RealtimeToStockQuoteService_res_1 


ie te | 4 | 





An “Add inputs” dialog will appear. 


37. Expand IIB Resources > “DFDL and XML Schemas” and select 
getQuoteResponse {hitp://sq.betaworks.ibm.com}. 


Click OK. 


Page 44 








19 Add Inputs 


Filter map input names (? = any character, * = any String): 

Select a map input 

=| gai IIB_Resources 
=A davissmpriata maaan 






oO ie Body {http://schemas.xmlsoap.org/soap/envelope/} 


~f ie, Envelope {http://schemas.xmlsoap.org/soap/envelope/} 
Oo ie, Fault {http://schemas.xmlsoap.org/soap/envelope/} 

~{Z] LS getQuote {http://StockQuoteProvider /DelayedService/} 
Oo [el getQuote {http://StockQuoteProvider /RealtimeService/} 


oO ie getQuote {http://Resources/StockQuoteService} 


[J ER) getQuote {http://sq.betaworks.ibm.com} 

~O [fl getQuoteResponse {http://StockQuoteProvider/DelayedSe 

~O 
i 








a9 OTE pate ARNO ARES 





(& wsdlSM/StockQuote_InlineSchema 1.xsd 
Namespace: £8 {http://sq.betaworks.ibm.com} 


Lo | conet_| 
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38. Expand the “getQuoteResponse” element and map getQuoteReturn (float) from the input 
Message Assembly to value (float) on the output Message Assembly: 

















[ RealtmeToSteckCusteService_res_1 
*RealtimeToStockQuoteService_res_1 eS Pp | bi [> | x =} Bet ee & 
=) Pa=Message Assembly getQuot=Resporse =I [ie Message Assemaly JetOur 
=> <Glick to filter...> He <Click tw filter ..> 
Se : : 
+ £2] Properties [0..1] PropertiesT ype - @ pf Properties [o..4] Propertied 








EE cetQuoteRespors= [z..1] <Anonymg 
3 SDckOu9 















39. Set the LocalEnvironment on the input message assembly, as you did earlier. 


On the input message assembly, add the “sublevel” variable (in the same way that you added it to 
the output message before), and map the “sublevel (string)” variable from the input Message 
Assembly to “qualityOfService (string)” on the output Message Assembly. 




































































































































[ey RealtimeToStockQuoteService_res_i ; 
3 Pas Message Assembly getQuoteResponse = [ef Message Assembly getQuoteResponse iH 
& <Clck to filter...> > <Click to filter... > 4 

© gg] LocalEnvironment [0.1] _LocalEnvironmentType “  de] Properties [0.1] PropertiesType } 
 [€] Destination (0..1) _LocalEnvironmentDestinationType ) gf] cetQuoteResponse [1.1] <Anenymous> f 
& [€] WrittenDestination [0.1] _LocalénvironmentWrittenDestinationT ype & (@] response [1.1] StockQuoteResponse 
& [©] Aggregation (0..4) _LocalEnvironmentAggregationType = = 
® [e] DecisionServices (0..4] _LocalEnvironmentDecsionServicesT ype [e] qualityOfService [0.1] _ string 
w [2] HTTP (0..1] _LocalEnvironmentHTTPType 
[El Fie 0.1] _LocalEnvironmen FileType } 
& [E] soap [0..1] | _LocalEnvironmentSOAPType 3 
@ [e] SCA (0..2] _LocalEnvironmentSCAT ype ; 
[2] Sequence (0.1) _LocalEnvironmentSequenceT ype \ 
& (e) TCPIP (0..i) _LocalEnvironmentTCPIPType 
®& ([&] ServiceReaistry [0.1] _LocalEnvironmentServiceRegistryType 
@ [&] ServiceRegisiryLookupProperties (0..1] _LocalEnvironmentServiceRegistryLookupT ype 
w [€] Adapter (0..1] _LocalEnvironmentAdapterType ? 
ae 4 
& [E] Variables } 
Slany 0.7] 3 
el sublevel ; 
Se ae eee enter 


Make sure the mapping is set to “Move”. 


Repeat the same steps (37. — 41.) for the “DelayedT oStockQuoteService” node, and Save. 
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40. You’re nearly there! You have to make some final changes to the remaining Mapping Nodes to 
allow the LocalEnvironment to be propagated correctly through the flow. 


Open the “TransformToRealTime” Mapping Node. Add the LocalEnvironment to both Input and 
Output as before. This time map the LocalEnvironment entirely from the input to the output 
message assembly. 





{ Transform ToReallime_rea_l 








~+TransformToRealTime_req1 | i 


g 3 
Ludivine. [0.2] _LocalEnvire mmenitType _-ocalEnvirenmentType 


@ gl Properties [0.1] PropertiesType 


& fl getQuote <Anonymous> 


(S| BF] getwuote [2.1] <Ancnymous> 
= [&] request [1.1] StockQuoteRequest 
[El symbol [0.2] strine “| Move ~ 





2] symbol sting 


[e] astonerID 0.1] strinc 





Make sure the mapping is set to “Move”. 


41. Repeat the same steps for the “TransformToDelayed” node, and Save. 
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42. Finally, delete the “SetQualityOfService” JavaCompute Node. Connect the 
“RealTimeToStockQuoteService” and “DelayedToStockQuoteService” to the 
“StockQuoteService_getQuote_InputResponse” output node: 


You can do this because the flow already has the Subscription Level variable for our customer on 
the local environment, and you don’t need to set this again in the flow. 





StockQuoteSeryce _getQuote_InputResponss 


Rees OS BER Fi 





—— Ele 


DelayedStockQuoteFail 
oo / 


DelayedService_SOAPExtract DelayedToStockQuoteService 








As we already have the Subscription Level variable for our customer on the local environment we 
don’t need to set this again in the flow. 


One key feature of the Conversion procedure is that it allows you to keep the integration logic but 
use the IIB model to preserve the variables and message information as you are doing here with 
the Subscription Level information,,. 


Save the flow one last time. 
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4. Test the IIB_StockQuote Service 


1. Expand the WESB_Resources folder and expand Flow Tests. Open IIB_StockQuote.mbtest. 


EI a WESB_Resources 
ES. Schema Definitions 
( WSDL Definitions 


eS Baie 
Se cll Independent Resources 
G23 CustomExtension 


C "| 





2. There are two test messages. One for a Premium customer (CustomerA) and another for a 
Regular customer (CustomerB). Click “Send Message”. 





[& RealtimeToStockQuote | (S| StockQuote.xsd | <> TransformToDelayed_r 





Events 


i Select the message flow you would like to test. Click Send Message to run 
> General Properties 
~ Detailed Properties 


Message Flow Test Events 


























Po|eSS/5aR 
[EF Invoke Message Flow(CustomerA - Premium) Message flow: | /IIB_StockQuote/IIB_StockQuote.msgfiow [eal 
EF Invoke Message Flow(CustomerB - Regular) :  [StockQuoteService i] 
‘ation |getQuote (in: getQuoteRequest; out: getQuoteResponse) x 
Body: [Edit as xm structure fea 





Eaieclage 





Header Header 
| Body Body 
& getQuote anyType 
© request StockQuoteRequest 
symbol string IBM 
customerID string CustomerA 
any anyType [] <null> 

















Send Message 











Saved Messages | | Show Generated Source... 
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3. Adialog window will pop. Select the “default” Integration Server. Click “Finish” button. 


19 Select Deployment Location s Dl x; 


Specify deployment details 


e 
This server instance is currently running. A E - ", 

































= Beene New Local Integration Node... | 
=} IBSNODE 
& eeat Connect to Remote Integration Node ... | 


tong] IBONODE2 


T~ Trace and debug 
J | Stop at the beginning of the How during debugaing 
IV Always use the same deployment location for every test run 





(?) = Back Next > Cancel | 





4. You should receive this response for CustomerA: 





> General Properties 














~= Detailed Properties 
Encboint URL: |nttp:/Jocalhost:7800/StockQuoteWes/s-a/StockOuoteService 
PMcssage 
Body: view 2s XML structure >] 














E] out-getQuoteResponse 
xmins:out http: //Resources/StoccQuoteService 
& response 
value 2.02039993286132E42 
qualityOfServize = premium 

















This concludes the WESB conversion lab. 
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5. Appendix | 


Mediation Primitive Converters 





























Mediation Primitive | Convert to Usage Converter class 
Callout Request (for | StockQuote_MediationFlow. | Built-in converter 
example component 
SOAPReauest) 
CalloutResponse Request (for | StockQuote_MediationFlow. | Built-in converter 
example component 
SOAPRequest) 
Errorlnput Subflow placeholder | StockQuote_MediationFlow. | Placeholder converter 
component 
Fail Subflow placeholder | StockQuote_MediationFlow. | Placeholder converter 
component 
Input Input StockQuote_MediationFlow. | Built-in converter 
component 
InputResponse Reply (for example | StockQuote_MediationFlow. | Built-in converter 
SOAPReply) component 
MessageElementSe | JavaCompute StockQuote_MediationFlow. | Built-in converter 
tter component 
MessageFilter Route StockQuote_MediationFlow. | Built-in converter 


component 





MessageLogger 


Subflow placeholder 


StockQuote_MediationFlow. 


component 


Placeholder converter 








XSL Transformation 





Map 





StockQuote_MediationFlow. 


component 





Built-in converter 








Export and Import Binding Converters 














Binding Convert to Usage Converter class 

Jax/Ws Export SOAPInput StockQuoteService.export Com.ibm.etools.mft.conver 
sion.esb.extension. binding 
.JaxWsExportConverter 

Jax/Ws Import SOAPRequest DelayedService.import, Com.ibm.etools.mft.conver 








RealtimeService.import 





sion.esb.extension.binding 
JaxWslImportConverter 
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